home *** CD-ROM | disk | FTP | other *** search
/ BCI NET / BCI NET Dec 94.iso / archives / programming / libraries / mui20dev.lha / MUI / Developer / Autodocs / MUI_Area.doc < prev    next >
Text File  |  1994-02-11  |  22KB  |  904 lines
  1. TABLE OF CONTENTS
  2.  
  3. Area.mui/Area.mui
  4. Area.mui/MUIM_AskMinMax
  5. Area.mui/MUIM_Cleanup
  6. Area.mui/MUIM_Draw
  7. Area.mui/MUIM_HandleInput
  8. Area.mui/MUIM_Hide
  9. Area.mui/MUIM_Setup
  10. Area.mui/MUIM_Show
  11. Area.mui/MUIA_ApplicationObject
  12. Area.mui/MUIA_Background
  13. Area.mui/MUIA_BottomEdge
  14. Area.mui/MUIA_ControlChar
  15. Area.mui/MUIA_Disabled
  16. Area.mui/MUIA_ExportID
  17. Area.mui/MUIA_FixHeight
  18. Area.mui/MUIA_FixHeightTxt
  19. Area.mui/MUIA_FixWidth
  20. Area.mui/MUIA_FixWidthTxt
  21. Area.mui/MUIA_Font
  22. Area.mui/MUIA_Frame
  23. Area.mui/MUIA_FramePhantomHoriz
  24. Area.mui/MUIA_FrameTitle
  25. Area.mui/MUIA_Height
  26. Area.mui/MUIA_HorizWeight
  27. Area.mui/MUIA_InnerBottom
  28. Area.mui/MUIA_InnerLeft
  29. Area.mui/MUIA_InnerRight
  30. Area.mui/MUIA_InnerTop
  31. Area.mui/MUIA_InputMode
  32. Area.mui/MUIA_LeftEdge
  33. Area.mui/MUIA_Pressed
  34. Area.mui/MUIA_RightEdge
  35. Area.mui/MUIA_Selected
  36. Area.mui/MUIA_ShowMe
  37. Area.mui/MUIA_ShowSelState
  38. Area.mui/MUIA_Timer
  39. Area.mui/MUIA_TopEdge
  40. Area.mui/MUIA_VertWeight
  41. Area.mui/MUIA_Weight
  42. Area.mui/MUIA_Width
  43. Area.mui/MUIA_Window
  44. Area.mui/MUIA_WindowObject
  45. Area.mui/Area.mui
  46.  
  47.     Area class is a super class for every other MUI class
  48.     except windows and applications. It holds information
  49.     about an objects current position, size and weight
  50.     and manages frames, fonts and backgrounds.
  51.  
  52.     Additionally, area class handles the user input. By
  53.     setting an objects MUIA_InputMode, you can make it
  54.     behave like a button or like a toggle gadget. That's
  55.     why MUI doesn't offer an extra button class. A button
  56.     is simply a text object with a raised frame and a relverify
  57.     input mode. Since especially group class is a subclass
  58.     of area, you can create rather complex buttons consisting
  59.     of many other display elements.
  60. Area.mui/MUIM_AskMinMax
  61.  
  62.     NAME
  63.     MUIM_AskMinMax
  64.     [For use within custom classes only]
  65.  
  66.     SYNOPSIS
  67.     DoMethod(obj,MUIM_AskMinMax,struct MUI_MinMax *MinMaxInfo);
  68.  
  69.     FUNCTION
  70.     see developer documentation.
  71. Area.mui/MUIM_Cleanup
  72.  
  73.     NAME
  74.     MUIM_Cleanup
  75.     [For use within custom classes only]
  76.  
  77.     SYNOPSIS
  78.     DoMethod(obj,MUIM_Cleanup,);
  79.  
  80.     FUNCTION
  81.     see developer documentation.
  82. Area.mui/MUIM_Draw
  83.  
  84.     NAME
  85.     MUIM_Draw
  86.     [For use within custom classes only]
  87.  
  88.     SYNOPSIS
  89.     DoMethod(obj,MUIM_Draw,ULONG flags);
  90.  
  91.     FUNCTION
  92.     see developer documentation.
  93. Area.mui/MUIM_HandleInput
  94.  
  95.     NAME
  96.     MUIM_HandleInput
  97.     [For use within custom classes only]
  98.  
  99.     SYNOPSIS
  100.     DoMethod(obj,MUIM_HandleInput,struct IntuiMessage *imsg, LONG muikey);
  101.  
  102.     FUNCTION
  103.     see developer documentation.
  104. Area.mui/MUIM_Hide
  105.  
  106.     NAME
  107.     MUIM_Hide
  108.     [For use within custom classes only]
  109.  
  110.     SYNOPSIS
  111.     DoMethod(obj,MUIM_Hide,);
  112.  
  113.     FUNCTION
  114.     see developer documentation.
  115. Area.mui/MUIM_Setup
  116.  
  117.     NAME
  118.     MUIM_Setup
  119.     [For use within custom classes only]
  120.  
  121.     SYNOPSIS
  122.     DoMethod(obj,MUIM_Setup,struct MUI_RenderInfo *RenderInfo);
  123.  
  124.     FUNCTION
  125.     see developer documentation.
  126. Area.mui/MUIM_Show
  127.  
  128.     NAME
  129.     MUIM_Show
  130.     [For use within custom classes only]
  131.  
  132.     SYNOPSIS
  133.     DoMethod(obj,MUIM_Show,);
  134.  
  135.     FUNCTION
  136.     see developer documentation.
  137. Area.mui/MUIA_ApplicationObject
  138.  
  139.     NAME
  140.     MUIA_ApplicationObject -- [..G], Object *
  141.  
  142.     FUNCTION
  143.     You can obtain a pointer to the application object
  144.     that some gadget belongs to by using this attribute.
  145.     Useful mainly within callback hooks if you do not want
  146.     to deal with global variables.
  147.  
  148.     SEE ALSO
  149.     MUIA_WindowObject
  150. Area.mui/MUIA_Background
  151.  
  152.     NAME
  153.     MUIA_Background -- [IS.], LONG
  154.  
  155.     FUNCTION
  156.     Adjust the background for an object.
  157.  
  158.     Every MUI object has its own background setting.
  159.     The background is displayed "behind" the actual
  160.     object contents, e.g. behind a the text of a
  161.     text object or behind the image of an image object.
  162.  
  163.     This attribute takes the same values as MUIA_Image_Spec,
  164.     please refer to autodocs of image class for a complete
  165.     description.
  166.  
  167.     An object without a specific background setting will
  168.     inherit the pattern from its parent group. The default
  169.     background for a window and many other background
  170.     patterns are adjustable with the preferences program.
  171.  
  172.     Only a few MUII_xxxxxxx tags make sense as background.
  173.     Important are:
  174.  
  175.     MUII_ButtonBack:
  176.        You have to set this when you create a button gadget.
  177.        Thus, your button will be displayed in the users
  178.        preferred style.
  179.  
  180.     MUII_TextBack:
  181.        Set this when you create a text object with a TextFrame,
  182.        e.g. some kind of status line. Do *not* use MUII_TextBack
  183.        for simple text without frame (e.g. gadget labels).
  184.  
  185.     MUII_BACKGROUND
  186.     MUII_SHADOW
  187.     MUII_SHINE
  188.     MUII_FILL
  189.     MUII_SHADOWBACK
  190.     MUII_SHADOWFILL
  191.     MUII_SHADOWSHINE
  192.     MUII_FILLBACK
  193.     MUII_FILLSHINE
  194.     MUII_SHINEBACK
  195.     MUII_SHINEBACK2:
  196.        One of MUI's predefined pattern. These are not
  197.        configurable by the user and will always look the
  198.        same.
  199.  
  200.     Note: It is *important* that you test your programs with
  201.           a fancy pattern configuration. With the default
  202.           setting you won't notice any errors in your backgrounds.
  203. Area.mui/MUIA_BottomEdge
  204.  
  205.     NAME
  206.     MUIA_BottomEdge -- [..G], LONG
  207.  
  208.     FUNCTION
  209.     You can use this to read the current position and
  210.     dimension of an object, if you e.g. need it to pop
  211.     up some requester below.
  212.  
  213.     Of course, this attribute is only valid when the
  214.     parent window of the object is currently open.
  215.  
  216.     SEE ALSO
  217.     MUIA_TopEdge, MUIA_Width, MUIA_Height,
  218.     MUIA_RightEdge, MUIA_LeftEdge
  219. Area.mui/MUIA_ControlChar
  220.  
  221.     NAME
  222.     MUIA_ControlChar -- [I..], char
  223.  
  224.     FUNCTION
  225.     Pressing the control char will have the same effect
  226.     as pressing return if the object was active.
  227.     
  228.     This can be used to create old style key shortcuts.
  229.  
  230.     Note: Using an uppercase control char will force
  231.           the user to press shift.
  232.  
  233.     SEE ALSO
  234.     mui.h / KeyButton() macro
  235. Area.mui/MUIA_Disabled
  236.  
  237.     NAME
  238.     MUIA_Disabled -- [ISG], BOOL
  239.  
  240.     FUNCTION
  241.     Disable or enable a gadget. Setting this attribute
  242.     causes a gadget to become disabled, it gets a ghost
  243.     pattern and doesn't respond to user input any longer.
  244.  
  245.     Disabled gadgets cannot be activated with the TAB key.
  246.  
  247.     Using MUIA_Disable on a group of objects will disable
  248.     all objects within that group.
  249.  
  250.     EXAMPLE
  251.     /* we have a radio button gadget with three         */
  252.     /* entries, the third should enable a string gadget */
  253.     /* with additional parameters                       */
  254.  
  255.     DoMethod(radio, MUIM_Notify, MUIA_Radio_Active, 0,
  256.        string, 3, MUIM_Set, MUIA_Disabled, TRUE);
  257.  
  258.     DoMethod(radio, MUIM_Notify, MUIA_Radio_Active, 1,
  259.        string, 3, MUIM_Set, MUIA_Disabled, TRUE);
  260.  
  261.     DoMethod(radio, MUIM_Notify, MUIA_Radio_Active, 2,
  262.        string, 3, MUIM_Set, MUIA_Disabled, FALSE);
  263. Area.mui/MUIA_ExportID
  264.  
  265.     NAME
  266.     MUIA_ExportID -- [ISG], LONG
  267.  
  268.     FUNCTION
  269.     Objects with a non NULL MUIA_ExportID export their
  270.     contents during MUIM_Application_Save and import
  271.     them during MUIM_Application_Load.
  272.  
  273.     You have to use different ExportIDs for your objects!
  274.  
  275.     SEE ALSO
  276.     MUIM_Application_Save, MUIM_Application_Load
  277. Area.mui/MUIA_FixHeight
  278.  
  279.     NAME
  280.     MUIA_FixHeight -- [I..], LONG
  281.  
  282.     FUNCTION
  283.     Give your object a fixed pixel height. This tag is
  284.     absolutely not needed in a general MUI application
  285.     and only present for emergency situations. Please
  286.     think twice before using it!
  287.  
  288.     EXAMPLE
  289.     /* create an 8x8 pixel rectangle with FILLPEN */
  290.  
  291.     RectangleObject,
  292.        MUIA_FixWidth  , 8,
  293.        MUIA_FixHeight , 8,
  294.        MUIA_Background, MUII_FILL,
  295.        End;
  296.  
  297.     SEE ALSO
  298.     MUIA_FixWidth, MUIA_FixWidthTxt, MUIA_FixHeightTxt
  299. Area.mui/MUIA_FixHeightTxt
  300.  
  301.     NAME
  302.     MUIA_FixHeightTxt -- [I..], LONG
  303.  
  304.     FUNCTION
  305.     Give your object a fixed pixel height. The height
  306.     will match the height of the given string. This tag is
  307.     absolutely not needed in a general MUI application
  308.     and only present for emergency situations. Please
  309.     think twice before using it!
  310.  
  311.     EXAMPLE
  312.     /* create a fixed size rectangle with FILLPEN */
  313.  
  314.     RectangleObject,
  315.        MUIA_FixWidthTxt , "00:00:00",
  316.        MUIA_FixHeightTxt, "\n\n",
  317.        MUIA_Background  , MUII_FILL,
  318.        End;
  319.  
  320.     SEE ALSO
  321.     MUIA_FixHeight, MUIA_FixWidth, MUIA_FixWidthTxt
  322. Area.mui/MUIA_FixWidth
  323.  
  324.     NAME
  325.     MUIA_FixWidth -- [I..], LONG
  326.  
  327.     FUNCTION
  328.     Give your object a fixed pixel width. This tag is
  329.     absolutely not needed in a general MUI application
  330.     and only present for emergency situations. Please
  331.     think twice before using it!
  332.  
  333.     EXAMPLE
  334.     /* create an 8x8 pixel rectangle with FILLPEN */
  335.  
  336.     RectangleObject,
  337.        MUIA_FixWidth  , 8,
  338.        MUIA_FixHeight , 8,
  339.        MUIA_Background, MUII_FILL,
  340.        End;
  341.  
  342.     SEE ALSO
  343.     MUIA_FixHeight, MUIA_FixWidthTxt, MUIA_FixHeightTxt
  344. Area.mui/MUIA_FixWidthTxt
  345.  
  346.     NAME
  347.     MUIA_FixWidthTxt -- [I..], STRPTR
  348.  
  349.     FUNCTION
  350.     Give your object a fixed pixel width. The width
  351.     will match the width of the given string. This tag is
  352.     absolutely not needed in a general MUI application
  353.     and only present for emergency situations. Please
  354.     think twice before using it!
  355.  
  356.     EXAMPLE
  357.     /* create a fixed size rectangle with FILLPEN */
  358.  
  359.     RectangleObject,
  360.        MUIA_FixWidthTxt , "00:00:00",
  361.        MUIA_FixHeightTxt, "\n\n",
  362.        MUIA_Background  , MUII_FILL,
  363.        End;
  364.  
  365.     SEE ALSO
  366.     MUIA_FixHeight, MUIA_FixWidth, MUIA_FixHeightTxt
  367. Area.mui/MUIA_Font
  368.  
  369.     NAME
  370.     MUIA_Font -- [I.G], struct TextFont *
  371.  
  372.     SPECIAL INPUTS
  373.     MUIV_Font_Inherit
  374.     MUIV_Font_Normal
  375.     MUIV_Font_List
  376.     MUIV_Font_Tiny
  377.     MUIV_Font_Fixed
  378.     MUIV_Font_Title
  379.  
  380.     FUNCTION
  381.     Every MUI object can have its own font, just set it with
  382.     this tag. Objects without an explicit font setting will
  383.     inherit it from their parent group.
  384.  
  385.     You normally won't need to open a font yourself, just
  386.     use one of the predefined values to get a font from
  387.     the users preferences.
  388.  
  389.     EXAMPLE
  390.     /* since the text contains tabs,           */
  391.     /* use the fixed width font for displaying */
  392.  
  393.     msgread = FloattextObject,
  394.        MUIA_Font, MUIV_Font_Fixed,
  395.        ...,
  396.        End;
  397. Area.mui/MUIA_Frame
  398.  
  399.     NAME
  400.     MUIA_Frame -- [I..], LONG
  401.  
  402.     SPECIAL INPUTS
  403.     MUIV_Frame_None
  404.     MUIV_Frame_Button
  405.     MUIV_Frame_ImageButton
  406.     MUIV_Frame_Text
  407.     MUIV_Frame_String
  408.     MUIV_Frame_ReadList
  409.     MUIV_Frame_InputList
  410.     MUIV_Frame_Prop
  411.     MUIV_Frame_Gauge
  412.     MUIV_Frame_Group
  413.     MUIV_Frame_PopUp
  414.     MUIV_Frame_Virtual
  415.     MUIV_Frame_Slider
  416.     MUIV_Frame_Count
  417.  
  418.     FUNCTION
  419.     Define a frame for the current object. Since area class
  420.     is a superclass for all elements in a window, you can
  421.     assign frames to every object you wish.
  422.  
  423.     You don't adjust the style of your frame directly,
  424.     instead you only specify a type:
  425.  
  426.     MUIV_Frame_Button
  427.        for standard buttons with text in it.
  428.  
  429.     MUIV_Frame_ImageButton
  430.        for small buttons with images, e.g. the arrows
  431.        of a scrollbar.
  432.  
  433.     MUIV_Frame_Text
  434.        for a text field, e.g. a status line display.
  435.  
  436.     MUIV_Frame_String
  437.        for a string gadget.
  438.  
  439.     MUIV_Frame_ReadList
  440.        for a read only list.
  441.  
  442.     MUIV_Frame_InputList
  443.        for a list that handles input (has a cursor).
  444.  
  445.     MUIV_Frame_Prop
  446.        for proportional gadgets.
  447.  
  448.     MUIV_Frame_Group
  449.        for groups.
  450.  
  451.     How the frame is going to look is adjustable via the
  452.     preferences program.
  453.  
  454.     Four spacing values belong to each frame that tell
  455.     MUI how many pixels should be left free between the
  456.     frame and its contents. These spacing values are also
  457.     user adjustable as long as you don't override them
  458.     with one of the MUIA_InnerXXXX tags.
  459.  
  460.     Note: The first object in a window (MUIA_Window_RootObject)
  461.           may *not* have a frame. If you need this you will have
  462.           to create a dummy group with just one child.
  463.  
  464.     EXAMPLE
  465.     strobj = StringObject,
  466.        MUIA_Frame, MUIV_Frame_String,
  467.        End;
  468.  
  469.     SEE ALSO
  470.     MUIA_InnerLeft, MUIA_InnerRight, MUIA_InnerTop,
  471.     MUIA_InnerBottom
  472. Area.mui/MUIA_FramePhantomHoriz
  473.  
  474.     NAME
  475.     MUIA_FramePhantomHoriz -- [I..], BOOL
  476.  
  477.     FUNCTION
  478.     Setting this to TRUE causes the specified frame to be
  479.     a horizontal phantom frame. The frame will not appear
  480.     but its vertical components (frame height, inner
  481.     top and inner bottom spacing) will be used to calculate
  482.     positions and dimensions (horizontal components are
  483.     treated as 0).
  484.  
  485.     This is extremely useful for a correct labeling of objects.
  486.     You would e.g. label a string gadget by using a text object
  487.     with a phantom string frame. Thus, the label text will
  488.     be always on the same vertical position as the string
  489.     gadget text, no matter what spacing values the user
  490.     configured.
  491.  
  492.     SEE ALSO
  493.     Label() macros in "mui.h".
  494. Area.mui/MUIA_FrameTitle
  495.  
  496.     NAME
  497.     MUIA_FrameTitle -- [I..], STRPTR
  498.  
  499.     FUNCTION
  500.     This tag identifies a text string that will be displayed
  501.     centered in the top line of a frame. This can become
  502.     handy if you want to name groups of objects.
  503.  
  504.     You may not use MUIA_FrameTitle without defining
  505.     a MUIA_Frame.
  506.  
  507.     EXAMPLE
  508.     VGroup,
  509.        MUIA_Frame     , MUIV_Frame_Group,
  510.        MUIA_FrameTitle, "Spacing",
  511.        ...
  512.  
  513.     SEE ALSO
  514.     MUIA_Frame
  515. Area.mui/MUIA_Height
  516.  
  517.     NAME
  518.     MUIA_Height -- [..G], LONG
  519.  
  520.     FUNCTION
  521.     You can use this to read the current position and
  522.     dimension of an object, if you e.g. need it to pop
  523.     up some requester below.
  524.  
  525.     Of course, this attribute is only valid when the
  526.     parent window of the object is currently open.
  527.  
  528.     SEE ALSO
  529.     MUIA_TopEdge, MUIA_Width, MUIA_LeftEdge,
  530.     MUIA_RightEdge, MUIA_BottomEdge
  531. Area.mui/MUIA_HorizWeight
  532.  
  533.     NAME
  534.     MUIA_HorizWeight -- [I..], LONG
  535.  
  536.     FUNCTION
  537.     Adjust the horizontal weight of an object. Usually
  538.     you can simply use MUIA_Weight instead of this tag
  539.     but in some two-dimensional groups it may become
  540.     handy to have different horizontal and vertical 
  541.     weights.
  542.  
  543.     SEE ALSO
  544.     MUIA_Weight
  545. Area.mui/MUIA_InnerBottom
  546.  
  547.     NAME
  548.     MUIA_InnerBottom -- [I..], LONG
  549.  
  550.     FUNCTION
  551.     Adjust the space between an object and its frame.
  552.     Usually you shouldn't use this tag since you will
  553.     override the users preferred default setting.
  554.  
  555.     SEE ALSO
  556.     MUIA_Frame
  557. Area.mui/MUIA_InnerLeft
  558.  
  559.     NAME
  560.     MUIA_InnerLeft -- [I..], LONG
  561.  
  562.     FUNCTION
  563.     Adjust the space between an object and its frame.
  564.     Usually you shouldn't use this tag since you will
  565.     override the users preferred default setting.
  566.  
  567.     SEE ALSO
  568.     MUIA_Frame
  569. Area.mui/MUIA_InnerRight
  570.  
  571.     NAME
  572.     MUIA_InnerRight -- [I..], LONG
  573.  
  574.     FUNCTION
  575.     Adjust the space between an object and its frame.
  576.     Usually you shouldn't use this tag since you will
  577.     override the users preferred default setting.
  578.  
  579.     SEE ALSO
  580.     MUIA_Frame
  581. Area.mui/MUIA_InnerTop
  582.  
  583.     NAME
  584.     MUIA_InnerTop -- [I..], LONG
  585.  
  586.     FUNCTION
  587.     Adjust the space between an object and its frame.
  588.     Usually you shouldn't use this tag since you will
  589.     override the users preferred default setting.
  590.  
  591.     SEE ALSO
  592.     MUIA_Frame
  593. Area.mui/MUIA_InputMode
  594.  
  595.     NAME
  596.     MUIA_InputMode -- [I..], LONG
  597.  
  598.     SPECIAL INPUTS
  599.     MUIV_InputMode_None
  600.     MUIV_InputMode_RelVerify
  601.     MUIV_InputMode_Immediate
  602.     MUIV_InputMode_Toggle
  603.  
  604.     FUNCTION
  605.     Adjust the input mode for an object.
  606.  
  607.     MUI has no distinct button class. Instead you can make
  608.     every object (even groups) behave like a button by
  609.     setting an input mode for them. Several input modes
  610.     area available:
  611.  
  612.     MUIV_InputMode_None:
  613.        No input, this is not a gadget.
  614.  
  615.     MUIV_InputMode_RelVerify:
  616.        For buttons and similar stuff.
  617.  
  618.     MUIV_InputMode_Immediate:
  619.        Used e.g. in a radio button object.
  620.  
  621.     MUIV_InputMode_ToggleSelect:
  622.        For things like checkmark gadgets.
  623.  
  624.     The input mode setting determines how a user action
  625.     will trigger the attributes MUIA_Selected, MUIA_Pressed
  626.     and MUIA_Timer. See their documentation for details.
  627.  
  628.     EXAMPLE
  629.     /* A traditional button, just a text object with */
  630.     /* a button frame and a relverify input mode:    */
  631.  
  632.     okbutton = TextObject,
  633.        MUIA_Frame        , MUIV_Frame_Button,
  634.        MUIA_InputMode    , MUIV_InputMode_RelVerify,
  635.        MUIA_Text_Contents, "OK",
  636.        ...
  637.  
  638.     SEE ALSO
  639.     MUIA_Selected, MUIA_Timer, MUIA_Pressed
  640. Area.mui/MUIA_LeftEdge
  641.  
  642.     NAME
  643.     MUIA_LeftEdge -- [..G], LONG
  644.  
  645.     FUNCTION
  646.     You can use this to read the current position and
  647.     dimension of an object, if you e.g. need it to pop
  648.     up some requester below.
  649.  
  650.     Of course, this attribute is only valid when the
  651.     parent window of the object is currently open.
  652.  
  653.     SEE ALSO
  654.     MUIA_TopEdge, MUIA_Width, MUIA_Height,
  655.     MUIA_RightEdge, MUIA_BottomEdge
  656. Area.mui/MUIA_Pressed
  657.  
  658.     NAME
  659.     MUIA_Pressed -- [..G], BOOL
  660.  
  661.     FUNCTION
  662.     Learn if a button is pressed (or released).
  663.     The MUIA_Pressed attribute of a gadget is triggered
  664.     by some user action, depending on the input mode:
  665.  
  666.     MUIV_InputMode_RelVerify:
  667.        - set when lmb is pressed.
  668.        - cleared when lmb is released and the mouse
  669.          is still over the gadget (otherwise it will
  670.          be cleared too, but without triggering a
  671.          notification event).
  672.  
  673.     MUIV_InputMode_Immediate:
  674.        - undefined, use MUIA_Selected for this.
  675.  
  676.     MUIV_InputMode_Toggle:
  677.        - undefined, use MUIA_Selected for this.
  678.  
  679.     Waiting for MUIA_Pressed getting FALSE is the usual
  680.     way to react on button gadgets.
  681.  
  682.     EXAMPLE
  683.     DoMethod(btcancel,MUIM_Notify,MUIA_Pressed,FALSE,
  684.        app,2,MUIM_Application_ReturnID,ID_CANCEL);
  685.  
  686.     SEE ALSO
  687.     MUIA_Selected, MUIA_Timer, MUIA_ShowSelState, MUIA_InputMode
  688. Area.mui/MUIA_RightEdge
  689.  
  690.     NAME
  691.     MUIA_RightEdge -- [..G], LONG
  692.  
  693.     FUNCTION
  694.     You can use this to read the current position and
  695.     dimension of an object, if you e.g. need it to pop
  696.     up some requester below.
  697.  
  698.     Of course, this attribute is only valid when the
  699.     parent window of the object is currently open.
  700.  
  701.     SEE ALSO
  702.     MUIA_TopEdge, MUIA_Width, MUIA_Height,
  703.     MUIA_LeftEdge, MUIA_BottomEdge
  704. Area.mui/MUIA_Selected
  705.  
  706.     NAME
  707.     MUIA_Selected -- [ISG], BOOL
  708.  
  709.     FUNCTION
  710.     Get and set the selected state of a gadget.
  711.     This attribute can be triggered by the user
  712.     clicking on the gadget (or using the keyboard),
  713.     depending on the input mode:
  714.  
  715.     MUIV_InputMode_RelVerify:
  716.        - set when lmb is pressed.
  717.        - cleared when lmb is released.
  718.        - cleared when the gadget is selected and the
  719.          mouse leaves the gadget box.
  720.        - set when the mouse reenters the gadget box.
  721.  
  722.     MUIV_InputMode_Immediate:
  723.        - set when lmb is pressed.
  724.  
  725.     MUIV_InputMode_Toggle:
  726.        - toggled when lmb is pressed.
  727.  
  728.     Of course you may set this attribute yourself, e.g.
  729.     to adjust the state of a checkmark gadget.
  730.  
  731.     A selected gadget will display its border reverse
  732.     and get the configured MUII_SelectedBack background.
  733.     This can be avoided using the MUIA_ShowSelState tag.
  734.  
  735.     SEE ALSO
  736.     MUIA_Pressed, MUIA_Timer, MUIA_ShowSelState, MUIA_InputMode
  737. Area.mui/MUIA_ShowMe
  738.  
  739.     NAME
  740.     MUIA_ShowMe -- [ISG], BOOL
  741.  
  742.     FUNCTION
  743.     Objects with this attribute set are not displayed. You can
  744.     set MUIA_ShowMe at any time, causing objects to appear and
  745.     to disappear immediately. A new layout is calculated whenever
  746.     some objects are shown or hidden. When necessary, MUI will
  747.     resize the parent window to make place for the new objects.
  748.  
  749.     NOTE
  750.     Currently, MUI does a complete window refresh after
  751.     showing/hiding objects. This behaviour might get improved
  752.     in the future.
  753. Area.mui/MUIA_ShowSelState
  754.  
  755.     NAME
  756.     MUIA_ShowSelState -- [I..], BOOL
  757.  
  758.     FUNCTION
  759.     Normally a gadget will reverse its frame and
  760.     display the configured MUII_SelectetBack background
  761.     pattern in its selected state. For some objects
  762.     (e.g. checkmarks) this is not recommended and
  763.     can be supressed by setting MUIA_ShowSelState
  764.     to FALSE.
  765.  
  766.     SEE ALSO
  767.     MUIA_Selected
  768. Area.mui/MUIA_Timer
  769.  
  770.     NAME
  771.     MUIA_Timer -- [..G], LONG
  772.  
  773.     FUNCTION
  774.     MUIA_Timer gets triggered when a relverify button is 
  775.     pressed and (after a little delay) increases every 
  776.     INTUITICK as long as the mouse remains over the gadget.
  777.  
  778.     This makes it possible to have buttons repeatedly
  779.     cause some actions, just like the arrow gadgets of
  780.     a scrollbar.
  781.  
  782.     EXAMPLE
  783.     DoMethod(btmore,MUIM_Notify,MUIA_Timer,MUIV_EveryTime,
  784.        app,2,MUIM_Application_ReturnID,ID_MORE);
  785.  
  786.     DoMethod(btless,MUIM_Notify,MUIA_Timer,MUIV_EveryTime,
  787.        app,2,MUIM_Application_ReturnID,ID_LESS);
  788.  
  789.     SEE ALSO
  790.     MUIA_Pressed, MUIA_Selected
  791. Area.mui/MUIA_TopEdge
  792.  
  793.     NAME
  794.     MUIA_TopEdge -- [..G], LONG
  795.  
  796.     FUNCTION
  797.     You can use this to read the current position and
  798.     dimension of an object, if you e.g. need it to pop
  799.     up some requester below.
  800.  
  801.     Of course, this attribute is only valid when the
  802.     parent window of the object is currently open.
  803.  
  804.     SEE ALSO
  805.     MUIA_LeftEdge, MUIA_Width, MUIA_Height,
  806.     MUIA_RightEdge, MUIA_BottomEdge
  807. Area.mui/MUIA_VertWeight
  808.  
  809.     NAME
  810.     MUIA_VertWeight -- [I..], LONG
  811.  
  812.     FUNCTION
  813.     Adjust the vertical weight of an object. Usually
  814.     you can simply use MUIA_Weight instead of this tag
  815.     but in some two-dimensional groups it may become
  816.     handy to have different horizontal and vertical
  817.     weights.
  818.  
  819.     SEE ALSO
  820.     MUIA_Weight
  821. Area.mui/MUIA_Weight
  822.  
  823.     NAME
  824.     MUIA_Weight -- [I..], LONG
  825.  
  826.     FUNCTION
  827.     This tag is a shorthand for MUIA_HorizWeight and
  828.     MUIA_VertHeight, it sets both weights at once.
  829.  
  830.     The weight of an object determines how much room it
  831.     will get during the layout process. Imagine you have
  832.     a 100 pixel wide horizontal group with two string
  833.     gadgets. Usually, each gadget will get half of the
  834.     room and be 50 pixels wide. If you feel the left
  835.     gadget is more important and should be bigger,
  836.     you can give it a weight of 200 (and 100 for
  837.     the right gadget). Because the left gadget is
  838.     twice as "heavy" as the right gadget, it will
  839.     become twice as big (about 66 pixel) as the
  840.     right one (34 pixel).
  841.  
  842.     Of course giving weights only makes sense if the
  843.     object is resizable. A MUIA_VertWeight for a
  844.     (always fixed height) string gadget is useless.
  845.  
  846.     An object with a weight of 0 will always stay
  847.     at its minimum size.
  848.  
  849.     By default, all objects have a weight of 100.
  850.  
  851.     EXAMPLE
  852.     HGroup,
  853.        StringGadget, MUIA_Weight,  50, End,
  854.        StringGadget, MUIA_Weight, 100, End,
  855.        StringGadget, MUIA_Weight, 200, End,
  856.        End;
  857.  
  858.     SEE ALSO
  859.     MUIA_HorizWeight, MUIA_VertWeight
  860. Area.mui/MUIA_Width
  861.  
  862.     NAME
  863.     MUIA_Width -- [..G], LONG
  864.  
  865.     FUNCTION
  866.     You can use this to read the current position and
  867.     dimension of an object, if you e.g. need it to pop
  868.     up some requester below.
  869.  
  870.     Of course, this attribute is only valid when the
  871.     parent window of the object is currently open.
  872.  
  873.     SEE ALSO
  874.     MUIA_TopEdge, MUIA_LeftEdge, MUIA_Height,
  875.     MUIA_RightEdge, MUIA_BottomEdge
  876. Area.mui/MUIA_Window
  877.  
  878.     NAME
  879.     MUIA_Window -- [..G], struct Window *
  880.  
  881.     FUNCTION
  882.     This attribute can be used to get a pointer to the
  883.     intuition window structure of the parent window 
  884.     ot the object. This pointer could e.g. be used
  885.     in calls to asl.library.
  886.  
  887.     The result is only valid when the window is opened.
  888.  
  889.     SEE ALSO
  890.     MUIA_Window_Window
  891. Area.mui/MUIA_WindowObject
  892.  
  893.     NAME
  894.     MUIA_WindowObject -- [..G], Object *
  895.  
  896.     FUNCTION
  897.     You can obtain a pointer to the window object
  898.     that some gadget belongs to by using this attribute.
  899.     Useful mainly within callback hooks if you do not want
  900.     to deal with global variables.
  901.  
  902.     SEE ALSO
  903.     MUIA_ApplicationObject
  904.